home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / comms / pipeln10.zip / README < prev    next >
Text File  |  1990-08-14  |  4KB  |  67 lines
  1.                        TSR COMMUNICATION UTILITIES
  2.                            Release 1.0, 6/1/90
  3.                             James W. Birdsall
  4.  
  5.    This release contains: AQUEDUCT.COM version 1.20, PIPELINE.COM version
  6. 1.00, and VALVE.EXE 1.10, as well as associated source code. These programs
  7. are copyrighted, but may be distributed freely so long as they are not
  8. modified. If you do modify any of these programs, please indicate the
  9. modifications on any copies you distribute.
  10.  
  11.    AQUEDUCT and PIPELINE are small TSRs which connect COM1 and COM2 in
  12. software. Thus, another computer connected to COM2 (on the computer
  13. running the TSR) can communicate with a modem connected to COM1, or vice
  14. versa. Since these programs are TSRs, the computer running them can be used
  15. for other programs in the foreground.
  16.    These programs are run from the command line with no arguments. Setup
  17. and activation are performed using the program VALVE (see below). These
  18. programs can be set (using VALVE) to chain to the previous interrupt
  19. handler, so if you are using a mouse or whatever on COM3 or COM4, these
  20. programs should coexist peacefully.
  21.    WARNING: due to the nature of the PC environment, these programs are not
  22. absolutely robust. Programs running in the foreground may interfere with
  23. the correct operation of the TSRs. Disk access seems to cause particular
  24. problems. However, they only rarely stop functioning entirely, and even
  25. then can usually be revived through use of VALVE (see below). Other TSRs
  26. may also interfere with correct operation. For example, I have had
  27. interesting problems with mouse drivers. When loaded in one order, the
  28. mouse driver failed; when loaded in the other order, both worked fine.
  29.    PIPELINE is more robust than AQUEDUCT under most circumstances. These
  30. programs will run under DOS 2.0 and up. PIPELINE requires 448 bytes, and
  31. AQUEDUCT requires 816 bytes. PIPELINE consumes about 2% of the CPU of a
  32. 4.77 mHz XT, and AQUEDUCT consumes about 10%.
  33.    Source code is easily modifiable to provide support for your particular
  34. COM3 and COM4 -- all you have to do is change some defined values, which
  35. are marked in the source code.
  36.    WARNING: Neither program checks for already-installed copies before
  37. installing itself. This is done deliberately; if the current copy hangs so
  38. badly that it cannot be revived with VALVE, another copy may be installed
  39. over the first.
  40.  
  41.    VALVE provides support functions for PIPELINE and AQUEDUCT. It may be
  42. used to set up the COM ports, enable or disable the TSR, print out the
  43. current error count, or remove the TSR from memory. Baud rates of 110, 150,
  44. 300, 600, 1200, 2400, 4800, and 9600 are supported, although rates above
  45. 2400 are not recommended on slow computers. Modes of seven or eight data
  46. bits; even, odd, or no parity; and one or two stop bits are supported.
  47. Both COM ports are set up identically -- no baud conversion is possible.
  48. For syntax information, run VALVE with no arguments.
  49.    VALVE can usually revive a hung TSR with a disable/enable pair or by
  50. running setup again.
  51.    VALVE releases the TSR by manually freeing its memory block, since
  52. attempts to use DOS calls to do so failed. This should not cause problems.
  53.  
  54.    NOTE: Sometimes these programs mysteriously fail to work. The TSR
  55. installs fine, VALVE sets up the COM ports, and then nothing happens. A
  56. reboot is usually required to clear this condition, the cause of which has
  57. not been traced.
  58.  
  59.    I can be contacted at:
  60.         INTERNET:       71261.1731@compuserve.com
  61.             jwbirdsa@amc.com
  62.         CompuServe:     71261,1731
  63.         GEnie:          J.BIRDSALL2
  64.         US Mail:        James W. Birdsall
  65.             11112 NE 124th Lane, Apt. D-204
  66.             Kirkland, WA   98034
  67.